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PREFACE 


Intercomm is a state-of-the-art teleprocessing monitor system of 
SDA, operating under the control of IBM 360/370 Operating Systems (MFT, 
MVT, VS). Intercomm monitors the transmission of messages’ from 
terminals, concurrent message processing, centralized access to 1/0 
files, and the routine utility operations of editing input messages and 
formatting output messages, as required. 


The Autogen Facility Special Feature is an extension to the 
Message Mapping Utilities (MMU). Autogen allows screen layouts to be 
specified at the terminal. The terminal user enters field-oriented 
data according to prompting screens supplied by Autogen. MMU map 
definitions are generated as a result of the terminal session. 


This document provides an overview of Autogen operation for the 
terminal user and details installation procedures for the systems 
programmer. Specifics for use of Autogen at the terminal are provided 
by the Autogen prompting screens. 


The following prerequisite publications support the material 
contained herein: 


@ Concepts and Facilities 
@ Message Mapping Utilities Users Guide 
® Introduction to Programming the IBM 3270 (an IBM publication) 


Other technical publications related to Intercomm use _ are 
described on the previous page. 


A User Review Form is included at the back of this manual. We 
welcome recommendations, suggestions and reactions to this or any 
Intercomm publication. 
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Section 1 


INTRODUCTION 


1.1 MAP DEFINITIONS WITH MMU 


Intercomm Message Mapping Utilities (MMU) are provided to isolate 
terminal-oriented specifications from on-line application programs and to reduce 
the complexities of screen format considerations within the application program. 


Using MMU, the application programmer prepares screen format 
specifications by coding Assembler Language macros. These macros specify such 
information as constant values, field positioning information, field attribute 
information and other such items required to delineate CRT screen use. 


The collection of macros describing a screen layout is called a Map 
Definition. Following assembly, Map Definitions are used in the on-line 
environment to provide message formatting services in conjunction with application 
program processing. 


12 MAP DEFINITIONS WITH AUTOGEN 


The Autogen Special Feature provides a direct method of creating Map 
Definitions, speeding implementation of on-line applications by specification of 
terminal screen layout through the terminal itself. Autogen operates as an 
Intercomm application program (subsystem). 


Using Autogen, the application programmer enters a "model" of the screen 
layout desired, then submits this "model" to the Autogen facility. Autogen, through 
a series of prompting screens, requests additional information to complete the 
screen specifications and produces the Assembler Language macros required for 
MMU. 


After the general screen layout is defined, that layout is displayed to the 
user for detailed specification of names of variable fields and field attributes. This 
process completes the definition of one screen. The user may then continue to 
define additional screens, or terminate the session. 


A correction facility exists within Autogen which enables the user to return 
to a previous point within the prompting sequence for a map definition in order to 
change previously specified items. This correction facility is referred to as Revise 
Mode. 


1.3 AUTOGEN CAPABILITIES 


Autogen has been designed to provide automatic specification for a subset of 
MMU capabilities; that subset has been chosen to represent the majority of 
anticipated MMU usages. Autogen is designed for simplicity and ease of use. 
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MMU provides an extensive array of features that offer a 
diversity of complex formatting options, many of which produce an 
output format whose characteristics vary dynamically according to data 
content. In such formatting situations, direct assembler macro 
specification may still be required. 


Some of the advantages of the Autogen Special Feature are: 


© Proposed screen layouts can be analyzed and critiqued at the 
terminal to quickly correct design flaws such as clutter or 
awkward field positioning. 


® Proposed screen layouts can be created by analysts or 
programmers in conjunction with prospective system users to 
obtain immediate user reaction and feedback. 


@ Programmer requirement to understand MMU macro coding and 
other training requirements are decreased. 


e Programmer productivity is increased; programmer error rates 
can be decreased. 


Autogen uses existing system facilities and requires negligible 
system overhead. Depending on installation requirements, it can be 
defined as a high-priority resident subsystem or a lower priority 
dynamically loaded (or overlay region) subsystem. 


Autogen supports the IBM 3270 Model 2 terminal (1920-character 
screen) devices which are hardware compatible with the 3270, and the 
Teletype (Dataspeed) Model 40/1 and 2 terminals. 
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Chapter 2 
AUTOGEN OPERATIONS 


This chapter assumes knowledge of MMU facilities and 
macros as described in Message Mapping Utilities. 


2.1 AUTOGEN PROMPTING SCREENS 


Execution of Autogen is initiated by entry of a 
user-assigned Intercomm verb (e.g., AGEN) at the terminal. The 
Autogen subsystem then prompts the terminal operator with a series of 
screens requesting specific data for generating map definitions. The 
sequence of requests (Normal Mode) is: 


@® Specify map group name and mode, 
® Specify map name, 

@ Describe screen layout, 

@® Assign field names, 

e Assign numeric field types, 

e Assign field attributes, 


® Make additional map definition(s) for the map group, 
or 


® Define additional map groups or terminate session. 


The correction facility (Revise Mode) may be used after 
describing the screen layout to correct any previously entered 
specification for a particular map prior to starting definition of a 
subsequent map or map group. 


There are no restart procedures associated with Autogen. 
In the event of system failure and subsequent system restart, the 
Autogen prompting sequence must be reinitiated with entry of the 
Autogen verb. 


Figure 2-1 summarizes Autogen screens and_ terminal 
operator action for Normal Mode of operation. Cross-references to 
figures in this section that illustrate use of the screens are 
provided. 


2-1 
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Screen Title | Operator Reply Figure 
MAPGP-N Enter map group name and map group mode 
LAYOUT Enter screen [Enter screen layout 25, 2-6 2-6 


aaa field names for fields entered on the 


Enter changes to field names specified on 
CHGERR-N* Enter corrections to syntax errors from PNAMES 
entries 


| NUMTYPE-N* | Enter numeric field JEnter numeric field types } 2-10, 2-11 | 2-11 


Peers ee seinintitemeen A ae 2-13, 
Enter field attributes 2-14, 2-15 


Begin definition of a new map within the current 
Map group or terminate definition of this map 


group 


MOREMAPS* 2-16 


Begin definition of a new map group or terminate 


MOREGPS this AUTOGEN session 


* . Revise Mode can be entered from these screens. 


Figure 2-1. Autogen Screens and Replies, Normal Mode 


2.2 AUTOGEN MAP DEFINITIONS 


When the Autogen user specifies completion of a map group 
definition, Autogen produces a set of MMU Map Definition macros in 
symbolic form. The Map Definitions consist of: 


e MAPGROUP macro with map group name and mode as specified from 
the terminal. All maps are created with DEVICE=ALL (default) 


e MAP macro(s) with map name as specified from the terminal. 
Each map represents a full screen (24 rows, 80 columns), and 
specifies START=(1,1) 
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@ FIELD macro(s) for each data field specified on the screen 
layout (map). Field names and characteristics are derived 
from terminal input (or assume macro defaults, if not 
specified). All fields have ATTRIB=UAN by default, others 
may be_ specified. RELPOS generated for each field is 
relative positional and is that of the data area, not the 
attribute byte. RELPOS=VERB/AID/CURSOR, if desired, must be 
added to the map off-line. RELPOS=POS, keyword or fixed 
definitions are not applicable. Structured segments and 
occurring fields/segments are not applicable. 


If the terminal session defines more than one map group, a 
separator card (with * in column 1) is produced between each set of 
output map definitions. 


A user exit is provided within the Autogen output routine which 
allows the user to intercept and process each "card" output by 
Autogen. (See Appendix A.) 


2.3 GENERATING A MAP DEFINITION 


Use of Autogen is best illustrated by an example. Figure 2-2 
illustrates a typical screen layout for which Autogen is used to 
generate a Map Definition. The user (analyst or programmer) sketches 
such a layout, proceeds to the terminal, and enters the Autogen verb to 
initiate the Autogen session. 


In the discussion following, Normal Mode of operation is 
described; error procedures and use of Revise Mode are described in 
Sections 2.4 and 2.5. 


NOTE: All names specified during the Autogen session (map 
group, map, and field names) must begin with an 
alphabetic character. The remaining characters may be 
alphabetic or numeric only (no special characters, @, #, 
$, no blanks). Where Autogen requests entry of data into 
fields of a prompting screen, all data must be entered as 
left-justified values with no embedded blanks. 


2=3 


2.31 Specifying Map Group Name and Mode 


Figure 2-3 illustrates the MAPGP-N prompting screen with operator reply 
specifying the name of the map group to be defined. The name may be up to seven 
characters long and must be left-justified. The mode can be specified as 'T' for 
input, 'O' for output, or a blank, indicating the default of I/O may be used (see the 
MMU manual for a discussion of map group modes). 


If Input mode is specified, the FIELD macros subsequently generated for this 
map group will include the JUSTIFY= and COND=ENTERED parameters. If Output 
mode is specified, the macros generated include the JUSTIFY=, ATTRIB=, and 
INITIAL= parameters. If the default of I/O is chosen, all of the above parameters 
are included. 


@PANSGEMPLOYEE NO22 @NAMES@ 
@aOIVISICN:3 G@LOCATION:a SPOSITION:A 
aPAN OATE 3a QSTATUSS3 SEXEMPT73 aCLASS:a @ 


@INCREASE:a @NEw SALARY<a @EFFECTIVE OATE Sa @INCREASE CODEsa@ a 


@BONUS AMOUNT:3 @BONUS DATESAa a 
ASECURITY LEVEL3@ @SECURITY OATES@ QASECURITY OFFICE:4@ a 
SLOA START DATESa @LOA RETURN OATE:4 a 
ATERMINATION QATE:a AaTERMINATION COOE:a @ 

@REASON:@ 


aCOMMENTS@ 


Figure 2-2. A Typical Screen for Autogen Definition 
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INTERCOMM SCREEN SENERATION 
NORMAL MUQE - SCREEN MAPGP-N 


ENTER MAPGROUP Name PERSNEL 


THE MAPGROUP “OCE WILL 8E [70 CINPUT/CUTPUTS UNLESS Yeu SFECIFY EITHER I FOR 
INPUT OR QO FOUR OUTPUT HERE: 


a on ee re 


NOTE: Enter maximum 7-character name, left-justified, no embedded 
blanks (PERSNEL). This map group will be 1/0. 


Figure 2-3. MAPGP-N Screen Reply 


pi) 
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2342 Specifying Map Name ) 


Figure 2-4 illustrates the MAP-N prompting screen with operator 
reply specifying the map name to be defined. The name may be up to 
eight characters in length. 


THTERCOMM SCREEN GENERATION 
NORMAL SCOE © SCREEN MAP EN 


SUTER MAP (SCREEN) SAME PANSCRN 


NOTE: Enter maximum 8-character name, left-justified, no embedded 
blanks. (PANSCRN) 


Figure 2-4. MAP-N Screen Reply 
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20303 Describing the Screen Layout 


Figure 2-5 shows the LAYOUT prompting screen with operator reply. Note 
that an "at-sign", G, has been chosen as the character to indicate attribute byte 
positions on the screen. Following reply to the LAYOUT, Autogen clears the 
screen, and the user enters the desired screen layout, as illustrated by Figure 2-6. 
The layout entered on this blank screen becomes the basis for all subsequent 
specifications, and is referred to as the "layout screen" in this section. 


INTERCOMM SCREEN GENERATION 
NURMAL NOOE = SCREEN LAYOUT 


ENTER SCREEN LAYOUT. 


ENTER CONSTANT OR INITIAL=VALUED FIELOS AS THEIR VALUES. 
ENTER CHORACTER STELDS AS °K", 
ENTER NUMERTC FIELDS USING 'S%, *9" AND eye, 
ENTER YES/NO FIELDS AS fy, 
SELECTCR PEN SELECTICN FIELDS MUST S£GIN WITH °78, 
SELECTOR PEN ATTENTION FIELDS “UST BEGIN WITH *=*. 


ENTER FIELO ATTRIGUTE RYTES As "_* (UNCERSCORE). IF YCU WISH TO USE A CHARACTERS 
a 


OTHER THAN UNUERSCORE» PLEASE INDICATE IT HERE: 


NOTE: "@" is the designated indicator of attribute byte position. 


Figure 2-5. LAYOUT Screen Reply 
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SPANSGEMPLOYEE NO 23999999QNAME SSX XX AX KX AK AA AN ANAK AXNK SB 

@OLVISICN SGxXX GLO CATIONS IXXXSPOST TION SO XX XML AX LX KAKA KAK ALAN ALA 

SPAN DATE8999999SSTATUS ISXGEXEMPT?3YYYACLASS:Sx%8 

SINCREASESS99 -ISANEW SALARY 598999. 999EF FECTIVE OATESS99SSIISINCREASE CCOESaXxa 
@BOQNUS AMOUNT :29999993Q80NUS DATES 39999999 

@SECURITY LEVELI@XSSECURITY OATES Aa9999998SECURITY OFFICESaxa 

SLOA START OATE!35999998L0A RETURN 0ATE:99999999 


STERMINATION DATE S899S999S3TERMINATION CCOESax3 


@REASON SAXXXXXAXXNXX 


MXM AANA AKAAKRAXAXAXA 
SCOMMEN TSEXXXX AXA AX AAKAXAXX 
XRXKXMKAA AK AXAXAXAKA ANG 


NOTE: The entire field need not be filled with "X" or "9", as 
illustrated by the last 5 lines of this screen. 


Figure 2-6. User Screen Layout Definition 


2.3.4 Assigning Field Names 


Assigning field names is accomplished by first entering field 
names directly into the layout screen, keying over the previously 
entered fields. Field names at this point in the operation are 
restricted to seven characters or the length of the field itself, 
whichever is smallest. Field names may then be changed (lengthened) on 
the subsequent prompting screen to the maximum seven characters. Field 
names may consist of alphabetic characters and numeric digits; no 
special characters. 


Figure 2-7 illustrates the prompting screen TNAMES. The user at 
the terminal replies to TNAMES by pressing the ENTER key. Autogen then 
displays the previously entered screen layout and the user enters field 


names in the screen positions where field names are desired (Figure 
2-8) e 


After receiving the layout with screen names, Autogen presents 
the user with the PNAMES prompting screen. Figure 2-9 shows the PNAMES 
screen with the desired field name changes entered by the user. 


Field names assigned by replies to the TNAMES and PNAMES 
prompting sequence become Map Definition FIELD macro labels and thus 
are the symbolic field names referenced by application programs using 
the defined map. 
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INTERCOMM SCREE* GENERATION 
NORMAL MODE = SCREEN TNAMES=N 


ENTER FIELO NaMES FOR. VARTABLE FIELDS WITHIN THE FIELOS THEMSELVES ON THE 
FOLLOWING SCREENe NOTE’ THAT TEMPORARILY THE FIELD NAME MAY BE ONLY AS LONG AS 


THe FIELO. THe NEXT SET AF SCREEN@GENEKATION INSTRUCTIONS WILL ALLOY YoU TO 
LENGTHEN ANY FIELO NAME TO UP TO SEVEN CHARACTERS. 


IF YOU WISH TS ENTER REVISE MODE, ENTER A NON=BLANK CHARACTER, HERE: 


Figure 2-7. TNAMES-N Screen Reply 


dp vrelsevevovee NO SEM PNUMPNAME 5 GX XX XXX XfEMPM AME NX XX XKXXHK 2 

ADIVISICN SAI VBLOCATION: fLOGBP OSI TIONS Xx AP OST I TURXXXXXXX XXAX XXXS 

aPAN CATE: qPOATEPSSTATUS : {ape XEMPT 7 ABOqSCLASS scp 

a INCREASE: qT As Taney SALARY :(NEWSALBEF FECTIVE DATETAEOATEIAINCREASE CODE: qop 
ABONUS AMOUNT: qBGNAMTBBONUS DATE: qB0NGA Tp 


@SECURITY LEVELTAeBSECURITY OATE:GSECDA Tp SECURITY OFFICE: qep 
@LOA START DATESALOASTRBLOA RETURN OATESALOARE TH 
ATERMINATION CATE :qTDATESATERMINATION cove: {cpa 


aRE ASON 28 XXREASONMXX 
&COMMEN TSAXXXXICOMMSRX XXXXXX 


UX X MAK K AKA NXAAKAKAXAG 


MX MMM AK AK AK AANA XNA 


The field name (maximum seven characters) may be entered anywhere 
within the designated field position on the screen layout. See 
"EMPNAME", Line 1. 


The field name assigned must consist of characters other than those 
entered for each field on the layout screen. For example, if "xxxxxx" 
was used to define a field on the layout screen, the character "x" must 
not be used within a temporary field name. Similarly, if an 
initial-valued field was entered on the layout screen as "NAME:", and 
the desired field name is "NAME", enter "NAME" beginning in the 
second position of the 5-position initial-value field (the screen will 
show "NNAME"). 


Figure 2-8. Temporary Field Name Assignment 


__INTERCOMM SCREEN GENERATION 
NORMAL MOQOE = SCREEN FNAMES=N 


IF YOU WISH TO LENGTHEN OR OTHERWISt CHANGE ANY FIELO NAME GIVEN ON THE PREVIOUS 
SCRCENs ENTER HeRe PAIRS OF TEE FORM (COLDNAME sNEWNAME) WITH THE NAMES ENCLOSED 
IN PARENTHESES AND SEPARATED BY A COMMA, 


(A,STATUS) (BBB, EXEMPT) (C CLASS) ( TAMT, INCRAMT ) 
(EDATE, EFFDATE) (D,SPECIAL) (Ey SECLEV) 

(Fy SECOFC) (LOASTRy LOASTRT) 
(TDATE, TRMDATE) (Gy TRMCODE) 


NHCH-BLANK CHARACTER HERES 


IF YOU HAVE NO KEEG OF THIS OPTIONs ENTER A 


IF YOU WISH TO ENTER REVISE MODE. ENTER A NON@SLANK CRARACTER HERES 


NOTE: The field names entered here replace the field names of the TNAMES 
screen, as shown. 


Figure 2-9. PNAMES-N Screen Reply 


2idkD Assigning Numeric Field Types 


Following assignment of field names, the user is presented with the 
prompting screen NUMTYPE (Figure 2-10) to specify characteristics of numeric 
fields. The reply to this screen depends upon the type of numeric fields you wish to 
define. The fields specified as numeric at the layout screen may be defined as all 
of the same numeric type (one of those shown on the NUMTYPE display), or as a 
mixture of these types. 


If you want all numeric fields to be of the same type, enter the code for that 
type in the first indicated position and enter a non-blank character in the second 
indicated position. This causes the entered numeric-type code to apply to all 
numeric fields in the screen layout, and the next screen to appear is the attribute 
assignment screen. 


If numeric fields in the same screen layout are to be of different numeric 
types, enter the type code in the indicated default position and nothing in the 
second indicated position (Figure 2-10). The example shown indicates that most 
fields in the layout are to be zoned decimal. Entering nothing in the second 
indicated position causes the layout screen to be returned, rather than causing the 
ATTRIB-N screen to appear. 


INTERCOM™ SCREEN GENERATION 
NORMAL MODE = SCREEN NUMTYPERN 


NUMERIC FIELD TYPE CODES 


= 1-8YTE BINARY H = (UMALIGNED) HALFWORC Z =~ ZCNED CECIMAL 
- J-@YTE BINARY Fo = (UNALIGNED) FULL SORO P - PACKEC JECIMAL 


a 

2 

THE OEFAULT AUMERIC DATA TYPE WILL BE PACKED DECIMAL UAMLESS You ENTER ANOTHER 
TYPE CUCE HERES Z 


IF YOU wOULD LIKE ANY VARTABLE NUMERTC FIELO TO SE CF OATA TYFE OT-IER THAN THE 
OfFAULT,s ENTER THE TYPE COGE [WN Tre FIELO ON THE FCLLOSING SCKEEN. 


IF ALL NUMERIC DATA ARE TO 3f CF THE DEFAULT TYPE*e ENTER A KONFELANK CHARACTER 
HERES 


IF YOU bBISH TO ENTER REVISE MOOEs ENTER A NON-ALANK CHARACTER HERE? 


Figure 2-10. NUMTYPE-N Screen Reply 


Figure 2-11 illustrates operator reply to the returned layout screen, entering 
‘= desired numeric-type codes (other than the default type) anywhere within the 
numeric fields. 


SPANSGEMPLOYEE NO S99999994GNAME 5 OXXXAXAXAXARKXAKAX KAMAN KK AX AKAN 


BOIVISIONSSXXXSLOCATIONS IXXXIPOSI TIONS SXXXXXKAKKAXMAX NANAK NK XKXKXXXA 


BPAN DATE S3999999GSTATUS SGX GEXEMPTZAVYYSCLASS 23X32 


@INCREASE:a%p . Spaneu SALARY 229 9.]99aEF FECTIVE OATES A999999RINCREASE CODES axa 


QBONUS AMOUNT :aqp 9p99 aBONUS OATES a99999993 


@SECURITY LEVEL SAXaSECURITY DATES A99S9999ISECURITY OFFICE: 3Xa 
@LOA START OATESS9999998L0OA RETURN DATE539993994 
QTERMINATION DATE sa999999ATERMINATION COJE%aXKa 
BREASONSAXXXXXKXAXKK 
XX MX XRAAXAXAXXAXRAAXG 


@COMMEN TSAXXXAAXAXARAXKXAARXXX 
RXXX XAXAAKARAXXXAARKXAXXG 


NOTE: The field numeric-type code can be entered anywhere within the field 
area on the layout screen. See "Salary", line 4. 


Figure 2-11. Numeric Field Type Assignment 


rh 


aS 


20306 Assigning Field Attributes 


The final step in defining fields is to specify field attributes. The ATTRIB 
prompting screen allows the user to specify one attribute to be assigned. Autogen 
then displays the layout screen, and the user enters any non-blank character within 
the field to assume that attribute. Autogen then returns the ATTRIB screen for 
the user to make a second (or subsequent) attribute assignment. 


If the user reply to the ATTRIB screen is null (no attribute code entered), 
Autogen considers attribute assignment complete. Figures 2-12 and 2-13 illustrate 
assignment of one attribute, Figures 2-14 and 2-15 show assignment of a second 
attribute. One field may be assigned more than one attribute. 


INTERCOMM SCREEN GENERATION 
NORMEL MODE = SCREEN ATTRIB=N 


IF You WISH TO ASSIGN ANY FIELO ATTRIGUTEs ENTER THE STANCARD ATTRIBUTE CODE 
HERES MDTON _ THEN ASSIGN THE ATTRISUTE FOR A FIELO SY ENTERING ANY WNON@ELANK 
CHARACTER IN THE FIELD ON THE FOLLOWING SCREENS 

IF YOU wISH TC ENTER NO FURTHER SUCH ATTRIBUTES» MAKE NO ENTRIES IN THE ABOVE. 


IF YCU WISH T3 ENTER REVISE MOGEe ENTER A NON@ALANK CHARACTER HERES 


“PERMISSIBLE ATTRIBUTE CODES ARE AS FOLLoWS: 


RTJUST BLNKFILL FDTON HIGHINT 
LFuuST ZEROFILL AUTOSKIP SONOISP 


Figure 2-12. ATTRIB-N Screen Reply | 


fp sNspEMPLoYee NO S3999999GNAME TESPCSESTTOSELETOSESET ESSE. a 


GOTVISIONSSXXXGLOCATIONS AXXXaIPOSI TIONS SXXMXXK KX XANAX AN AXXAXAARAKA XXX 


G@PAN DATE 233999999 ASTATUS SaXGEXEMPT?GYYYVACLASS 5axa 


QINCREASE S399 eIDINEW SALARY SA99FeSDGEFFECTIVE DATESSISSSISIAINCREASE CODE Saxa 


@BONUS AMOUNT 2€9999998B0NUS JATE3 49999993 


@SECURITY LEVELS@xaSECURITY JATES A99999SRSECURITY OFFICES axa 


Q@LOA START OATESA999999ALOA RETURN DATE 53999999a 


A@TERMINATION DATE Sd999999ATERMINATION COJES axa 


BREASON SAXKXXAXXAXXKX 
XX XK AAAKXKX AK AAKA AX 


ACOMMENTS OXXXXXAX XX ARAAAKAX 
XAAX AX AAXAARXAXAAKXXA 


NOTE: Enter the attribute selection character (* in this example) anywhere 
within the field area on the layout screen. 


Figure 2-13. Attribute Assignment Screen | 


B=5 


INTERCOMNM SCREEN GENERATION 
NORMAL MOOE = SCREEN ATTRIB=N 


IF YOU WISH TO ASSIGN ANY FIELD ATTRIBUTEs ENTER THE STANCARD ATTRIBUTE COOE 
HERE: AUTOSKIP THEN ASSIGN THE ATTRISUTE FOR A FIELD 3Y ENTERING ANY NON@8LAKK 
CHARACTER IN THE FIELD ON THE FOLLOWING SCREENs 


IF YOU WISH TQ ENTER NO FURTHER SUCH ATTRIRUTESs MAKE NO ENTRIES IN THE ABOVE. 


IF YCU WISH TQ ENTER REVISE MODE», ENTER A NON@C6LANK CHARACTER HERE? = 


PERMISSIBLE ATTRIBUTE CODSS ARE AS FOLLOvS: 
RTJUST BLNKFILL MDTON HIGHINT 


LFuuST ZEROSTILL AUTOSKIP NONOISP 


Figure 2-14. ATTRIB-N Screen Reply 2 


tr Q 


-16 


{-husacnqepree NO 29999999aNAMeL ax xx XXX fof XRNH KKK EAXAHAK A [] 


a0 1foB1onsaxxxsLocdeh ON saxxxfePSIT LON 5 BXKAXXKAK AXAN KX KXK HXK HALAS Ey] 

ad-h DATE 28999999 aqeh TUS: axaqepnPTzavyvacLagef axa Cy 

a nqofasesa99.99anqe [SALARY :9999.999EF dap TIVE DATE 2999999 9qef CREASE copezaxa [+] 
aaq-ps AMOUNT 289999999B0NU] DATES 89999993 ig 

asqeparty LeveLzaxasd«priry DATE239999999Sq*ERITY OFFICE :axa [*] 

age |START DATES39999994L0A RqegRN DATE 539999994 ia 

aterd+faTion DATE :a999999ATERMINAT {=]i CODES aXa [=] 


AR A FON 29 XKNXAKAXKKX 
XXXXAXXXXAXAXAXNXAXANXNA 


aqefaen TSOXXXXARX KA AM ARARA 


XX AX AXXARAKMAAAXAKAAXXG 


NOTE: Enter the attribute selection character (* in this example) anywhere 
within the field area on the screen. 


Figure 2-15. Attribute Assignment Screen 2 


23.7 Terminating Map Group Definition 


The MOREMAPS prompting screen is displayed following attribute 
assignment. The reply to this screen is either YES or NO, depending upon whether 
or not there are further maps to be defined for this map group. A response of YES 
returns you to the MAP-N screen for definition of the next map in this group. A 
response of NO terminates definition of this map group, and the associated MMU 
macros are generated. (See Figure 2-16.) 


INTERCOMM SCREEN GENERATION 
NORMAL MODE = SCREEN ACROMAPS 


ARE THERE TO BE ANY FURTHER MAPS (SCREENS)? IN THIS SPCUP? 
ENTER *YES*® OR *NO®S NOL 


THIS IS YOUR FINAL OPPORTUNITY TO REVISE THIS MAPe IF YOU WISH TO ENTER REVISE 
MODEs ENTER A NON@BLANK CHARACTER HERES 


Figure 2-16. MOREMAPS Screen Reply 
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2.3.8 Terminating the Autogen Session 


If the reply to the MOREMAPS screen is NO, Autogen presents the 
user with the MOREGPS screen. (See Figure 2-17.) 


The reply to this screen is either YES or NO, depending on 
whether or not you wish to continue this Autogen session. A response 
of YES returns you to the MAPGP-N screen to begin definition of a new 
map group. A response of NO terminates this Autogen session and the 
message 


"AUTOGEN SESSION COMPLETED' 


is returned. The screen is unprotected; you may now choose another 
Intercomm function. 


INTERCO4A SCREEN GENERATION 
NORMAL MODE = SCREEN MOREGPS 


SRE THERE TO SE ANY FURTHER ae 


ENTER "YES*® OR *NOPS 


Figure 2-17. MOREGPS Screen Reply 
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2.4 ERROR PROCEDURES ) 


In the event of an invalid reply to a prompting screen or invalid 
input to a layout screen Autogen simply presents the user with a 
"refreshed" screen. The user then attempts the reply again. 


In the event of a syntax error on the PNAMES screen, the user is 
presented with a CHGERR screen (Figure 2-18). This screen is 
functionally equivalent to the PNAMES screens. The erroneous PNAMES 
screen entries appear on the screen for correction. The format for 
entry of corrections is identical to that of the original entry on the 
PNAMES screen: (oldname,newname). If a non-blank character is entered 
on the position indicated to specify that you do not wish to pursue the 
correction of field name changes, then field names remain as_ those 
assigned by the TNAMES screen procedure. 


INTERCOMM SCREEN GENERATION 
NORMAL MODE = SCREEN CHGERR=N 


THE FPOLLOWING CHANGE REQUESTS EITHER CONTAIN INVALIO SYNTAX OR SPECIFY A 
NONEXISTENT OLO NAME PLEASE REVISE THE REGUESTS AAO RE-ENTER. 


IF you CO NOT SISH TO PURSUE THESE CHANGES» ENTER A NON=8LANK CHARACTER HERES _ 


IF YoU WISH TC ENTER REVISE MODEs ENTER A NON@ALANK CHARACTER HERES 


Figure 2-18. CHGERR Screen 


262 REVISE MODE OPERATION 


Revise Mode may be entered at any time following entry of the ) 
layout screen by entering a non-blank character in the indicated | 
prompting screen position. 


2-20 


c 
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2651 Selecting Revision Type 


The REVSEL screen is displayed as a result of a request to enter 
Revise Mode. The reply to this screen specifies the type of revision 
you wish to make. (See Figure 2-19.) 


INTERCOMM SCREEN GENERATION 
REVISE MODE = SCREEN REVSEL 


SELECT TRE SCREE™ YOU WISH TS USE EY ENTERING ITS NUMSER HERES 


PAPGROUP MAME AMO MOQUE *) LIMITED LENGTH FIELS AAMES 
MAP (SCREEN) RAME S$) CHANGE FIELO NAMES 
SCRCEMN. LAYOUT» &} NUMERIC OATA TYPES 

7) ASSIGHU/DELETE FIELO ATTRIBUTES 


* NOTE THAT STRICTLY THERE IS NO "REVISE “ONE* FOR SCREEN LAaYQUT. SINCE A 
REVISTON OF Tee SCREEN LATOUT REQUIRES RESPECIFICATICN GF ALL FIELO NAMES, 
NUMERIC O4TA TYPES ARO FTELO ATTAISUTESs YOUR SELECTICN CF TKIS CPTICN WILL 
RETURK YGU TO NORMAL MOOE. 


Figure 2-19. REVSEL Screen 


Zeded Revise Mode Prompting Screens 


The prompting screen associated with the revision type selected 
is then displayed. Revise Mode prompting screens are identical to 
Normal Mode prompting screens (with the exception of ATTRIB, which 
allows revision and/or deletion of previously specified attributes) but 
do not include the option to enter Revise Mode. Revise Mode screen 
names are suffixed with "-R'' to distinguish them from Normal Mode 
screen names (suffixed with "-N"). Lf option 3 (LAYOUT screen is 
chosen, a blank screen is returned; the entire layout must be recreated. 


When using the NUMTYPE-R Option (6), all numeric codes must be 
respecified (except the indicated default in this screen). 


When choosing TNAMES-R option (4), do not press the ENTER key. 
After this screen is displayed, enter RLSE command to receive the 
LAYOUT screen. When using the PNAMES-R option (5), only short names 
entered in the previous TNAMES-R processing may be changed/expanded. 
Those entered in Normal mode may not be changed. 


2-21 


2039 Continuing from Revise Mode 


Following completion of the input associated with the revision type selected, J 
the user is presented with the REVCON screen to specify continuation options as 
shown in Figure 2-20. It provides the user with the option to remain in Revise 
Mode, return to Normal Mode, or terminate the current map definition. 


INTERCOMH SCREEN GENERATION 
REVISE MCDE = SCREEN REWCON 


SELECT THE wAY IN WHICH YOU WISH TO CONTINUE BY ENTERING THE APPROPRIATE SPTION 
NUMBER HERES : 


1) RETURN TO NGRFAL MCOE FROM THE POINT WHERE REVISE MODE WAS ENTERED. 

2) REMAIN IN REVISE MCCEs SELECTING THE NEXT SCREEN TO USE 

3> CONTINUE FRC THE SCREEM JUST USED IN NORMAL MCOE, LOSING CCNNECTION WITH 
THE PSINT WHEORE REVISE "ODE WAS ENTERED. 

4) ALL SPECIFICATION FCR THIS “AP COMPLETE. 


Figure 2-20. REVCON Screen 
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Chapter 3 


INSTALLATION PROCEDURES 


This chapter assumes knowledge of i Intercomm installation 


procedures as described in the Operating Reference Manual, Message 
Mapping Utilities, and Store/Fetch Facility. 


S54 AUTOGEN REQUIREMENTS 


The Autogen Special Feature is available for installation with 
Intercomm Release 8.0. Installation of Autogen requires: 


e Installation of Message Mapping Utilities and Store/Fetch 
@ SPALIST parameter specifications 


e® Autogen subsystem definition in Front End Verb Table and 
Subsystem Control Table 


@ Autogen subsystem linkedit 
® Autogen map load to MMU Store/Fetch Map Data Set 


@® Store/Fetch data set initialization (if an existing 
Store/Fetch data set is not to be used by Autogen) 


@ Intercomm linkedit (if Autogen subsystem is not to be 
dynamically loaded) 


@ Autogen JCL additions to Intercomm execution JCL. 


3.2 MMU AND STORE/FETCH INSTALLATION 


Installation procedures for the Message Mapping Utilities (MMU) 
are described in Message Mapping Utilities. There are no special MMU 
installation requirements for use of Autogen. MMU utilizes two 
Store/Fetch data sets, specified by the MMU Vector Table (MMUVTBL). 


Installation procedures for the Store/Fetch Facility are described 
in the Store/Fetch Facility. There are no special Store/Fetch 
Installation requirements for use of Autogen, except possible 
initialization of a Store/Fetch data set (see Section 3.7). 


3.3. SPALIST PARAMETER SPECIFICATION 


SPALIST macro parameters for Autogen are described below. Both the 
System Parameter Area (SPA CSECT) and Extension (SPAEXT CSECT) should be 
assembled and linkedited. The SPALIST macro is described in the Basic System 
Macros manual; procedures for coding, assembling and linkediting the System 
Parameter Area and Extension are described in the Operating Reference Manual. 


The SPALIST macro parameters associated with Autogen are: 


(symbol) SPALIST | ...... : 
-dd 
AUTOSED= (atone d 7 . 


_}/ddname-of-autogen-punch-file 
en cif AUTOGPCH } , 


nn 
AUTOMXF= woo) eence eeee 


AUTOSFD= 
is the ddname defining the Store/Fetch data set to be used by Autogen as a 
work file. It must be in the form INTSTORx, x=0, 1, ..., 9. The default is 
INTSTORO. Do not specify the same Store/Fetch data set used as the MMU 
Map Data Set (i.e., that specified by MMUVT macro MAPDDNM parameter). 


AUTOPCH= 
is the ddname defining the file that receives the generated map definition 
macros. The default value is AUTOGPCH. 


AUTOMXF= 
is the maximum number of fields that will be defined for one map generated 
by Autogen. Code as a decimal number in the range 1=nn$256. The default 
value is 100. 


3.4 AUTOGEN SUBSYSTEM DEFINITION 


The Autogen subsystem must be defined by a Front End Verb Table entry 
(BTVERB macro) and Subsystem Control Table entry (SYCTTBL macro). The 
Autogen verb and subsystem code are user-assigned. The values used in the 
example below are suggested values only. ; 


c 
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3.461 Front End Verb Table Entry 


Code a BTVERB macro for the Autogen Facility as illustrated in 


[symbo1]] BTVERB VERB=agen , SSCH=a , SSC=g , EDIT=NO[, CONV=3000 ] 


Figure 3-1. 


Do not code any parameters 
user-assigned values. It 
conversational subsystem, and 
as conversational (CONV=YES in 


BTVERB Macro Coding 
not shown above; "agen, "a'' and "g' are 
is recommended that Autogen be a 


that terminals using Autogen be defined 
BTERM). 


3.4.2 Subsystem Control Table Entry 


Code a SYCTITBL macro for the Autogen facility, as illustrated in 


Figure 3-2. 


[symbol] SYCTIBL | SUBH=a, SUBC=g, SPAC=5000, 
SBSP=ISGEN( , LOADNAM=AUTOGEN) , 
LANG=RBAL, MNCL=n, OVLY=n, 
NUMCL=n, DFLN=ddname, PCEN=n, 
RESTART=NO, CNVREST=NO, RVFILE=NO,.... 
(additional SYCTTBL parameters are user options) 


SUBH and SUBC must match the SSCH and SSC parameters in 


the BTVERB macro. 


OVLY and LOADNAM coding depend on resi- 


dency. The subsystem may be resident, overlay, or dynam- 
ically loaded. Lowercase parameter values are user-supplied. 


Figure 3-2. 


SYCTIBL Macro Coding 


3.5 AUTOGEN SUBSYSTEM LINKEDIT 


Figure 3-3 lists the Autogen members and CSECTs which reside on the 
Intercomm source and load module libraries PMILISYMREL and PMI.MODREL (or 
SYMLIB and MODLIB if modified). Additionally, source statement members 
ISGDATA and ISGFIT define DSECTs COPYed by Autogen programs. 


JCL for linkedit of the Autogen subsystem is shown in Figure 3-4. Total 
storage required is approximately LOK. 


Member and 
CSECT Name 


ISGEN Main program (subsystem entry point) 


ISGATTN Process attributes--Normal Mode 
| ISGATTR Process attributes--Revise Mode 


ISGNUMTY Process numeric field types 


ISGOUT | Generates Map Definition output 


Figure 3-3. Autogen Members and Functions 


/{/AGENLINK EXEC LKEDP,Q=LIB,LMOD=AUTOGEN 
//LKED.SYSIN DD * 
INCLUDE SY SLIB(ISGEN,ISGOUT,ISGLONGS) 
INCLUDE SYSLIB(UISGATTN,ISGATTR,ISGLYOUT) 


ENTRY ISGEN 
NAME AUTOGEN(R) 


| 
j 
I 
: 
| 
| INCLUDE SYSLIB(ISGLNAMS,ISGCNAMS,ISGNUMTY) 
| 
[ 
| 


NOTE: © LMOD and NAME must correspond to the SYCTTBL LOADNAM operand 
if AUTOGEN is a dynamically loaded subsystem. 


Figure 3-4. Autogen Subsystem Linkedit 


S94 


After Autogen subsystem linkedit, the load module (LMOD=AUTOGEN or 
user name) may then be: 


@ Included as a resident subsystem in the Intercomm load module 


e Included and inserted as an overlay subsystem in the Intercomm load 
module 


@ Subject to dynamic linkedit (with proper execution time JCL) as an 
Intercomm dynamically loaded subsystem 


The ICOMLINK macro may be used to generate INCLUDE and INSERT cards 
to linkedit the Autogen release library members as an Overlay A subsystem. (See 
Section 3.8.) 

3.6 AUTOGEN MAP LOAD 

Autogen uses a set of MMU map definitions in its processing. The release 
library (PMILISYMREL) member containing Autogen Map Definition macros for 
Autogen maps is ISGMAPS. 


The Autogen Map Definition macros must be assembled and linkedited to the 
users map definition load module library (usually PMILMODMDF). See Figure 3-5. 


//MAPS EXEC ASMPCL,Q=MDF,NAME=ISGMAPS,_LMOD=ISGMAPS 


Figure 3-5. Autogen Map Assemble and Linkedit 


Subsequent execution of the LOADMAP utility will load the Autogen maps 
(along with other user maps) to the MMU Store/Fetch Map Data Set. Refer to the 
MMU Users Guide for LOADMAP utility JCL. 


Autogen map definitions use map group name ISG; the map names and 
associated screen types are listed in Figure 3-6. 


Normal Revise 
Mode Mode 
MAPGPN MAPGPR Obtain map group name 


PNAMESN PNAMESR Assign permanent field names 


Correct syntax errors in permanent field 
name processing 


MOREMAPS --- Ask if more maps for group 
MOREGPS --- Ask if more map groups 
--- REVSEL Select Revise Mode function 


--- REVCON Continuation from Revise Mode function 


CHGERRN CHGERRR 


Figure 3-6. Map Names Within ISG Map Group 


3.7 AUTOGEN STORE/FETCH DATA SET 


The Store/Fetch data set used by Autogen as a work file has the following 
characteristics: 


@ May be any Store/Fetch data set except the MMU Map Definition data 
set. 


@ May be shared with other applications using Store/Fetch data sets. 


@ May be the default Store/Fetch data set INTSTORO. 


Performance is optimized by utilizing a Store/Fetch data set with blocksize 
calculated as follows: 


BLKSIZE=24+52+1920+(16 * SPALIST-AUTOMXF-parameter -value)+256 


ye 


S/F S/F screen field work 
header key layout data area area 


If a Store/Fetch data set is to be created for Autogen, it must be 
preformatted by the off-line utility KEYCREAT. Refer to the Store/Fetch Facility 
Users Guide for execution procedures. 


3.8 INTERCOMM LINKEDIT 


The required Intercomm linkedit control cards for the Autogen subsystem 
(plus Store/Fetch and MMU) are generated by coding the ICOMLINK macro 
parameter AUTOGEN=YES. INCLUDE and INSERT cards are generated which 
linkedit Autogen as an Overlay Region A subsystem. 


If Autogen is to be a resident subsystem, remove the INSERT cards. If 
Autogen is to be a dynamically loaded subsystem, code the ICOMLINK parameter 
AUTOGENE=NO. 


Verify that the Autogen Subsystem Control Table entry specifies residency 
(SYCTTBL macro OVLY= parameter) corresponding to Intercomm linkedit options. 


3.9 INTERCOMM EXECUTION JCL 


A DD card for Autogen output must be supplied as illustrated in Figure 3-7 
(DCB parameter required for File Handler). 


//autopch DD SYSOUT=B,DCB=(LRECL=80, BLKSIZE=n*80) 
or 
//autopch DD DSNAMEs=pdsname(membername),DISP=SHR,DCB=(DSORG=PS) 


or 
//autopch DD DSNAME=filename,DISP=NEW, 

[| DC B=(DSORG=PS,LRECL=80, BLKSIZE=n*80,RECFM=FB), 
// UNIT =unit, VOL=SER =volser SPACE =(n*80,(x,y,),RLSE) 
autopch is the SPALIST specified ddname (default is AUTOGPCH). 


n indicates the number of records per block. 


unit and volser are user-supplied standard JCL specifications. 


x and y vary according to the anticipated number of fields and maps produced by | 


one execution. "x" may be estimated as x=(no. of fields + 4)*(no. of maps). 


Figure 3-7. Autogen Output DD Card 


A DD card for the Autogen Store/Fetch work file must be supplied (if a DD 
card for a Store/Fetch data set shared with other applications is not already 
present in JCL). The DD card is shown in Figure 3-8. 


//INSTORn DD DSNez=username, DISP=SHR, 


DC B=(DSORG=DA,OPTCD=EF,LIMCT=m) 


n is the SPALIST specified ddname (default is INSTORO). 


Figure 3-8. Autogen Store/Fetch DD Card 
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Appendix A 


OUTPUT USER EXIT 


A.l USE OF THE USER EXIT 


The Autogen Output User Exit is provided for the user who wishes to 
intercept the Autogen macro output. For example, it might be used to submit a job 
to the system via HASP's internal reader, or it may be directed to some data set as 


backup to the original output. 
A.2 USER EXIT CODING CONVENTIONS 


The exit routine is user-coded, must be reentrant, and must have a CSECT 
(entry point) name of ISGUOUT. Register conventions are shown in Figure A-l. 


Register | Description 
IN 13 Save Area 
Py 15 Entry Point Address (ISGUOUT) 
T l If negative, then initial call and (R1)=2's complement 


of map group name address. 
If positive, then (R1)=address of record to write. 
If zero, then final call; no more data for map group. 


0, (2-12) Not used. 


On 15 If 0, then Autogen Output routine writes macro 
Tp card to Autogen data set. 
U, If not 0, then no output performed. 


Figure A-l. Output User Exit Register Conventions 


Any Intercomm facilities available for reentrant subsystem use may be used 
by this user exit. 


A-1/A-2 
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Appendix B 


USING AUTOGEN ON TELETYPE (DATASPEED) 40/1 AND 2 TERMINALS 


NOTE: This section contains information unique to Teletype 
(Dataspeed) 40/1 and 2 terminals using the Autogen facility. 
It supplements the main sections of this manual. It also 
assumes full understanding of the Teletype (Dataspeed) 40/1 
and 2 "Terminal Dependent Considerations” in Section 5 of the 


Operating Reference Manual. 


B.l Features Permitted 


All supported features in the Autogen Facility may be used to 
create maps (which are 3270 compatible) on a Teletype 40/1,2 (DS40) 
Terminal. 


Note that the Teletype (Dataspeed) Model 40/4 is a 3270 
compatible terminal and is operated as such. 


B.2 Operational Considerations 


B.2.1 One Field Autogen Screens 


Autogen screens with only one field to be entered, or where only 
the first field in the map needs to be entered, may have the response 
entered in S/R mode as one field input. More than one field requires 
entry in Batch mode. Batch mode entry of multiple fields in an Autogen 


map must use the TAB key (generates HT symbol) to ‘skip' from field to 
field. 


Ba2e2 Batch Mode Entering 


The message ending character must be provided for entry in Batch 
mode. 


After entering data in a map in Batch mode and before sending, 
the cursor must be positioned to HOME (depress HOME key). 
Additionally, for a switched line terminal, depress the CURSOR TAB key 


before depressing the SEND key (make sure a READ time-out has not 
occured). 


B.2.3 No Response Required Screens 


If a Map requires no response (TNAMES-N, NUMTYPE, etc.) the 
RETURN key may be depressed in S/R mode without entering any data on a 
switched line terminal. On a leased line terminal, one PAD character 
(space) must be entered before depressing the RETURN key. 


B-1 
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B.2-4 LAYOUT Screen 


When creating/working with the LAYOUT screen, the NEW LINE key 
may be depressed to prevent transmission of extra blanks at the end of 
a line beyond significant data. Be careful not to clear previously 
created data on a line when changing the LAYOUT screen (indicating 
attributes, numeric field types, names). If this happens by mistake 
when depressing the NEW LINE key, ‘re-key the data for that line exactly 
before sending back the screen. The message ending character may be 
keyed after the last significant non-blank data; all 24 lines do not 
need to be sent. Always depress HOME key before starting to work on 
the screen. 


Leased line terminals only -- After depressing the HOME key and 
just before sending the screen, one PAD character must be entered (use 
CHAR INSERT key) in the first position of the first line. 


B.2.5 PNAMES and CHGERR Screens 


Entering pairs of names in the PNAMES and CHGERR screens (Normal 
or Revise mode): pairs should be entered starting in column 1. One or 
more pairs may be entered on one line, followed by NL (depress NEW LINE 
key) to position the cursor to the beginning of the next line. The end 
of the last unprotected line in this area on the screen is protected; 
if a pair(s) of names is entered on this line, use the TAB key to 
position the cursor to the next input field (end of screen). 


C AUTOGEN FACILITY 
INTERCOMMe USERS REVIEW FORM 


Name 
Position 
: Company 


see eC SBE TE TT METERS ST TT TE Ee TOE 


° We would appreciate your thoughts on the usefulness and readability 
of this publication. Please write your comments below. Continue if 
necessary on the back of this form. 


AE TP LL I ET I ST ES EO SI SE EST aE ESE PST OE A TT A STE TOA RE NT IT AS AIT STE TED PTE TEI ENGR TS EET SC ESB A SIE SEE ESD 
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